home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / bbs / aselect.zip / README.DOC < prev    next >
Text File  |  1996-05-27  |  4KB  |  98 lines
  1. ---------------------------------------------------------------------------
  2.   Area Selection for Maximus BBS v3+                            v0.2 beta
  3. ===========================================================================
  4.  
  5.  
  6.   Hello,
  7.  
  8.   Here is the second beta copy of my MEX program for selecting areas. It
  9. now works with either message areas or file areas. This code works fine for
  10. me, so any problems you may encounter are your own :>
  11.  
  12.   This program provides the user with a full screen listing of the areas
  13. that are available to them on your system. They can scroll through the list
  14. using the arrow keys, and select an area to use by hitting enter. If the
  15. user's system doesn't support ANSI then the default(ugly) maximus area
  16. selector is used.
  17.  
  18.   This is two programs in one. At the top of the aselect.mex file are two
  19. define statments that control which version is compiled. If it looks like
  20. so:
  21.  
  22. //#define FSELECT
  23. #define MSELECT
  24.  
  25.   that is, MSELECT is defined and FSELECT is not, then it will be compiled
  26. to select message areas. If it looks like this:
  27.  
  28. #define FSELECT
  29. //#define MSELECT
  30.  
  31.   then it will compile to select file areas. When yourun mex on the source,
  32. it will produce aselect.vm, which should be renamed to either mselect.vm
  33. or fselect.vm depending on which one you selected.
  34.  
  35.  To install it do the following:
  36.  
  37.   copy aselect.mex to your /max/m directory (where the .MEX files are)
  38.   copy xgetch.mh to the same directory if you do not alread have it.
  39.  
  40.   edit aselect.mex and enable the version you want to compile. Only one
  41. of the #define FSELECT/MSELECT defines should be enabled at a time. I'm
  42. not responsible if you do something silly like enabling both!
  43.  
  44.   run 'MEX aselect' to compile the MEX program. Rename the result (aselect.vm)
  45. to either fselect.vm or mselect.vm (depending on what you selected of course).
  46.  
  47.   Repeat this process for the other version if you want to use both (who
  48. wouldn't?!).
  49.  
  50.   Replace the standard maximus message area selector with it:
  51.  
  52.   MEX   m\mselect               Demoted "Area change"
  53.  
  54.   and the standard file area selector with:
  55.  
  56.   MEX   m\fselect               Demoted "Area change"
  57.  
  58.   and recompile your control files with 'SILT max'
  59.  
  60.   If you want to change the color scheme (why would you?) you can edit the
  61. GC_* color definitions at the top of aselect.mex
  62.  
  63.   If you have PGP and want to check the integrity of the source, you first
  64.   need my public key which is available from the following sources:
  65.  
  66.   finger blane@aa.net if you have internet access
  67.   http://www.aa.net/~blane on the world wide web
  68.   File request from 1:138/162 as PGPKEY
  69.   Or from the fidonet PKEY_DROP echo.
  70.  
  71.   After adding the key to your keyring, run 'pgp aselect.asc aselect.mex' to
  72.   verify my signature on the file. Its output should look like this:
  73.  
  74.   -------------[cut here]-------------------
  75.   File has signature.  Public key is required to check signature.
  76.   File 'aselect.$00' has signature, but with no text.
  77.   Text is assumed to be in file 'aselect.mex'.
  78.   .
  79.   Good signature from user "Brian Lane <blane@aa.net> 1:138/162".
  80.   Signature made 1996/05/28 01:44 GMT
  81.  
  82.   Signature and text are separate.  No output file produced.
  83.   
  84.   -------------[cut here]-------------------
  85.  
  86.   One note: Once you have changed the sourcecode, pgp will no longer
  87.   verify the signature. This is normal. 
  88.  
  89.   Good luck! I hope this makes your system a little easier for your users.
  90.  
  91.   All feedback can be sent to:
  92.  
  93.     Brian Lane at 1:138/162
  94.     blane@aa.net
  95.  
  96.     or by calling my BBS at (206)927-9219
  97.  
  98.